IApi.GetSlaveById 方法

使用 ID 從指定的從站取得詳細訊息。

命名空間：IntervalZero.KINGSTAR.Base.Api

組合： IntervalZero.KINGSTAR.Base.Api (於 IntervalZero.KINGSTAR.Base.dll) 版本：4.4.0.0

語法

C#VB 
KsReturn<SlaveStatus> GetSlaveById(
       int Index
)
Function GetSlaveById(
       Index As Integer
) As KsReturn(Of SlaveStatus)

參數

Index

型別：int

從站陣列的索引。當 EtherCAT 從站裝置啟動時，此索引具有與 SlaveId 相同的值，該值對應於從站裝置在網路中的位置。請注意，在 EtherCAT 進入運行 (Op) 狀態後，加入或移除網路上的任何從站裝置將改變各裝置在網路中的位置 (SlaveId)。儘管如此，從站的索引將保持不變。新增的裝置將排列在陣列的末端。對於更改後的所有從站，索引和 SlaveId 將不再匹配。上述行為模式僅適用於實體裝置；不適用於模擬裝置。詳細資訊請參閱 EnableHotConnect 中的使用案例。

回傳值

型別：KsReturn<SlaveStatus>

回傳一個 KsError 代碼及一個 SlaveStatus 值。

備註

使用 EtherCAT 迴路中的從站位置檢索指定從站的詳細資訊，由於使用的是從站 ID，因此不使用別名資訊。此僅適用於不區分軸或 I/O 的實際從站模組，請在 KINGSTAR 子系統啟動後使用。

可用的 EtherCAT 狀態

ecatInit, ecatBoot, ecatPreOP, ecatSafeOP, ecatOP

範例

C# 
                N/A

參見

IApi 介面

IntervalZero.KINGSTAR.Base.Api 命名空間